

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<script type="text/javascript" src="helpman_topicinit.js"></script>

<title>Create Custom Tagged Value Type  [Enterprise Architect User Guide]</title>

<meta name="keywords" content="Enterprise Architect, Sparx Systems, UML, Custom Tagged Values,Custom Tagged Values Create,Create,Create Custom Tagged Values,Create Masked Tagged Values,Masked Tagged Values,Masked Tagged Values Create,Tagged Value,Tagged Value Masked, Create,Tagged Value Custom, Create">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />

<link type="text/css" href="default.css" rel="stylesheet" />
<style type="text/css">
  A, A:Visited
  {
    color: #00F;
  }

  A:Active, A:Hover
  {
    color: #F00;
  }

  OL
  {
    margin: 5px 0 5px 48px;
  }

  UL
  {
    margin-bottom: 3px;
    margin-top: 0;
  }

  #nsr
  {
    background-color: #D4DFFF;
  }

  #nsr A
  {
    text-decoration: none;
  }

  #mainbody
  {
    padding: 8px;
  }

  .p_BodyText
  {
    padding: 5px 0;
  }
</style>



<style type="text/css" media="screen">
  BODY
  {
    background-color: #FFFFFF;
  }

  #nsr
  {
    padding: 6px 6px 0 6px;
    border-bottom: none;
    vertical-align: top;
    z-index: 2;
    visibility: visible;
    left: 0;
    top: 0;
    position: absolute;
  }

  #mainbody
  {
    left: 0;
    top: 0;
    margin: 0;
    position: absolute;
    padding: 10px;
    overflow: auto;
    height: 100%;
    z-index: 1;
    background-repeat: no-repeat;
    background-position: bottom right;
    background-attachment: fixed;
  }
</style>

<style type="text/css" media="print">
  #nsr
  {
    visibility: none;
  }

  #mainbody
  {
    overflow: visible;
  }
</style>
<script type="text/javascript" language="JavaScript" src="nonscroll.js"></script>

</head>
<body scroll="no">

<div id="page">



        <div id="content">
          <div id="content-inner">
          



  
          <div id="nsr">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr valign="top">
                <td align="left">
  


                  <p class="p_Heading1"><span class="f_Heading1">Create a Custom Tagged Value Type</span></p>



  
                </td>
                <td align="right">
                  <a href="introduction.htm" onmouseover="document.images.main.src='button_main_h.gif'" onmouseout="document.images.main.src='button_main.gif'">
                    <img name="main" src="button_main.gif" border=0 alt="Return to Introduction">
                  </a>&nbsp;
    
                  <a href="create_predefined_tagged_value.htm" onmouseover="document.images.prev.src='button_prev_h.gif'" onmouseout="document.images.prev.src='button_prev.gif'">
                    <img name=prev src="button_prev.gif" border=0 alt="Previous page" />
                  </a>&nbsp;
    
    
    
                  <a href="codetemplates_2.htm" onmouseover="document.images.next.src='button_next_h.gif'" onmouseout="document.images.next.src='button_next.gif'">
                    <img name=next src="button_next.gif" border=0 alt="Next page" />
                  </a>
    
    
                </td>
              </tr>
            </table>
          </div>
          <div id="mainbody">
  


                <p class="p_BodyText"><span class="f_BodyText">Creating a custom masked Tagged Value gives you great flexibility in designing model components that accept data entries. To create a masked Tagged Value follow the steps below:</span></p>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=1><span class="f_NumberedList">Select the </span><span class="f_MenuKeyField">Settings | UML</span><span class="f_NumberedList"> menu option. The </span><span class="f_UIControl">UML Types</span><span class="f_NumberedList"> dialog displays; select the </span><span class="f_UIControl">Tagged Value Types</span><span class="f_NumberedList"> tab.</span></li>
<li value=2><span class="f_NumberedList">In the </span><span class="f_MenuKeyField">Tag</span><span class="f_NumberedList"> field type an appropriate name for the Tagged Value.</span></li>
<li value=3><span class="f_NumberedList">In the </span><span class="f_MenuKeyField">Description</span><span class="f_NumberedList"> field type the purpose of the Tagged Value, if required.</span></li>
<li value=4><span class="f_NumberedList">In the </span><span class="f_MenuKeyField">Detail</span><span class="f_NumberedList"> field type </span><span class="f_MenuKeyField">Type=Custom;</span></li>
</ol>
<p class="p_BodyText"><span class="f_BodyText">The type </span><span class="f_MenuKeyField">Custom</span><span class="f_BodyText"> enables you to set up the appropriate mask, using the following characters to define the format of the mask:</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="0" border="0" style="border: none; border-spacing:0px; border-collapse: collapse;">
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="42" bgcolor="#e3e6ed" style="width:42px; background-color:#e3e6ed; border: solid 1px #000000;"><p class="p_Tableheader"><span class="f_Tableheader">Mask</span></p>
</td>
<td valign="top" width="454" bgcolor="#e3e6ed" style="width:454px; background-color:#e3e6ed; border: solid 1px #000000;"><p class="p_Tableheader"><span class="f_Tableheader">Description</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="42" style="width:42px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">D</span></p>
</td>
<td valign="top" width="454" style="width:454px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Enables the Tagged Value to display digits only.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="42" style="width:42px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">d</span></p>
</td>
<td valign="top" width="454" style="width:454px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Enables the Tagged Value to display digits or spaces.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="42" style="width:42px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">+</span></p>
</td>
<td valign="top" width="454" style="width:454px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Enables the use of </span><span class="f_Tabletext" style="font-style: italic; font-weight: bold;">+, -</span><span class="f_Tabletext"> or </span><span class="f_Tabletext" style="font-style: italic;">spaces</span><span class="f_Tabletext">.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="42" style="width:42px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">C</span></p>
</td>
<td valign="top" width="454" style="width:454px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Enables the use of alpha characters only.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="42" style="width:42px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">c</span></p>
</td>
<td valign="top" width="454" style="width:454px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Enables the Tagged Value to be an alpha character or a space.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="42" style="width:42px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">A</span></p>
</td>
<td valign="top" width="454" style="width:454px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Enables the use of alphanumeric characters.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="42" style="width:42px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">a</span></p>
</td>
<td valign="top" width="454" style="width:454px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Enables the Tagged Value to use alphanumeric values or a space.</span></p>
</td>
</tr>
</table>
</div>
<p class="p_BodyText"><span class="f_BodyText">In the diagram below the </span><span class="f_BodyText" style="font-weight: bold;">Mask</span><span class="f_BodyText"> configuration</span><span class="f_BodyText"> option shows syntax that first defines seven blank spaces, which are occupied by characters determined by the template option. The first two visible characters in the </span><span class="f_BodyText" style="font-weight: bold;">Mask</span><span class="f_BodyText"> option are represented by a lower case </span><span class="f_BodyText" style="font-style: italic; font-weight: bold;">c</span><span class="f_BodyText"> indicating that the enableable information can entered as either an alpha character or as a space. The following blank spaces again indicate space defined by the template option and the remaining characters are defined by the </span><span class="f_BodyText" style="font-style: italic; font-weight: bold;">d</span><span class="f_BodyText"> character, which represents the enableable characters as digits or spaces. The hyphen is present in the final output, splitting up the digits.</span></p>
<p class="p_BodyText"><span class="f_BodyText">With the </span><span class="f_BodyText" style="font-weight: bold;">Template</span><span class="f_BodyText"> configuration option, the syntax defines the template of the masked option by occupying the blank spaces that are present in the </span><span class="f_BodyText" style="font-weight: bold;">Mask</span><span class="f_BodyText"> option. The template is used to ensure that this information is present with every use of this custom Tagged Value. The underscored values indicate the area that is to be occupied by data input by the user as defined in the </span><span class="f_BodyText" style="font-weight: bold;">Mask</span><span class="f_BodyText"> option.</span></p>
<p class="p_TextIndentedL2"><img src="customtaggedvalue.png" width="651" height="386" border="0" alt="CustomTaggedValue"></p>




            </div>
          </div>
        </div>



</div>


</body>
</html>
